Touchscreen Installation Instructions Using XFree86 4.x
=======================================================

Linux drivers for Elo touchscreens are available in the public domain, typically on Linux installation CDs and various FTP sites such as www.xfree86.org. These Linux drivers are compatible with Elo AccuTouch E271-2210, IntelliTouch E281-2310, and IntelliTouch 2500S controllers. Elo TouchSystems is not responsible for the functionality of these drivers.

Driver Installation
-------------------

1. Install Linux and verify that the X Windows System is working correctly. We strongly recommend the system be configured to start in the command line mode and not be configured to start X Windows automatically.

2. Verify that the Elo touchscreen driver file, elographics_drv.o exists. For Redhat Linux 7.1 and 7.2 it can be found at the following location: /usr/X11R6/lib/modules/input/elographics_drv.o.

XF86Config-4 Configuration File

3. Edit the XF86Config-4 file, normally found in the /etc/X11 directory. The instructions below are for a touchscreen connected to COM one. In step five below, Option "Device" "/dev/ttyS0" specifies the COM port the touchscreen is connected to. Use Option "Device" "/dev/ttyS0" for COM one, Option "Device" "/dev/ttyS1" for COM two, Option "Device" "/dev/ttyS2" for COM three, and Option "Device" "/dev/ttyS3" for COM four.

4. Add the following line to the "ServerLayout" Section:

Inputdevice "touchscreen1" "SendCoreEvents"

5. Add the following section to the "Inputdevice" section:

Section "Inputdevice"
Identifier "touchscreen1"
Driver "elographics"
Option "Device" "/dev/ttyS0"
Option "AlwaysCore"
Option "screenno" "0"
Option "MinimumXPosition" "600"
Option "MaximumXPosition" "3600"
Option "MinimumYPosition" "600"
Option "MaximumYPosition" "3600"
Option "UntouchDelay" "3"
Option "ReportDelay" "1"
EndSection

6. Save changes to the XF86Config-4 file.

Restarting X
------------

7. If you configured your system to start X automatically, restart X by pressing Ctrl, Alt, Backspace. If you configured your system to start in a command line mode, type startx at the command line prompt. The touchmonitor should automatically be identified and the driver installed. Complete the steps in the Touchscreen Calibration section for accurate video to touch alignment.

Touchscreen Calibration
-----------------------

The default calibration values in the XF86Config-4 file (MinimumXPosition 600, MaximumXPosition 3600, MinimumYPosition 600, MaximumYPosition 3600) need to be manually adjusted for the touchscreen to be calibrated.

8. On CRTs, adjust the video image size and position as desired. The picture must lie within the touchscreen's active area. Using a felt-tip pen or dry marker, mark the video extremes in the corners. The touchscreen must be calibrated to the position of the video image. This step may not be necessary if you are using an LCD since the touchscreen active area should equal the display active area.

9. Boot the PC into DOS mode (booting from a DOS floppy if necessary).

10. Unzip the linux.zip file. Load the DOS touch driver, Elodev.exe, with the correct command for the model of controller you are using:

Elodev 2210,1,9600  if you are using a 2210 controller on COM1
Elodev 2210,2,9600  if you are using a 2210 controller on COM2
Elodev 2310,1,9600  if you are using a 2310 controller on COM1
Elodev 2310,2,9600  if you are using a 2310 controller on COM2
Elodev 2500,1,9600  if you are using a 2500 controller on COM1
Elodev 2500,2,9600  if you are using a 2500 controller on COM2

If you are using COM three or above type Elodev at the command prompt for the correct Elodev command line usage.

Once you see "Elodev installed", go to the next step.

11. Start the DOS calibration routine by typing: Elocallx

12. Select the video resolution (VGA, SVGA, etc.) that X Windows will be using with the cursor keys and then press the "Enter" key. The video mode will change.

13. Verify that the video image size and position is identical with the markings.

14. Press 'C' to calibrate in this video mode.

15. From a position of normal use, touch the three targets as they appear.

16. Press 'S' to exit the calibration program.

17. Write down the values of XLow, XHi, YLow and YHi. For example, XLow=567, XHi=3629, YLo=740, YHi=3661

18. Reboot the Linux operating system, edit the XF86Config-4 file, and insert the values output by Elocallx, where:

MinimumXPosition=XLow
MaximumXPosition=XHi
MinimumYPosition=YLow
MaximumYPosition=YHi

19. If you configured your system to start X automatically, restart X by pressing Ctrl, Alt, Backspace. If you configured your system to start in a command line mode, type startx at the command line prompt.

Troubleshooting
---------------

1. To verify that the touchmonitor is connected correctly to the PC and that it is functioning correctly, type the following command in an X terminal window:

od -h -w10 </dev/ttyS0  This is for COM1
od -h -w10 </dev/ttyS1  This is for COM2

Touch the screen and you should see a group of numbers scrolling down the screen.

2. The XF86Config-4 file is used by XFree86 version 4.x and the XF86Config file is used by XFree86 version 3.x. Furthermore, the touchscreen drivers are different for the different versions and are not interchangeable.

If you install Red Hat Linux 7.1 or 7.2 automatically with the CD, the install program determines the version of XFree86 based on the video card detected. This means you may have XFree86 version 3.x installed instead of XFree86 version 4.x. Open a terminal window and type X -showconfig at the command prompt to see what version of XFree86 you are using. The first line returned by this command gives the version number.

If you are using XFree86 version 4.x, use the touchscreen driver on the Red Hat Linux 7.1 or 7.2 CD and the XF86Config-4 file . If you are using XFree86 3.x, use the XF86Config file, and either download the touchscreen driver for version 3.x from the XFree86 website, www.xfree86.org, or get it from an earlier Red Hat CD that used version 3.x such as Linux version 6.2.